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S-C Macro Assembler for ProDOS 


At long last, the news you've all been waiting for: the ProDOSs 
version of the S-C Macro Assembler is almost ready. We have a 
working assembler in Beta testing, and it's doing just fine 

We need to spend another month or two shaking on it and 
developing documentation, so it will be just a little longer 
‘til we start shipping, but it's on the way! Watch the front 
page of AAL for the announcement. 


News from Don Lancaster 


After nearly a year of delay at the publisher, Enhancing Your 
Apple II and //e, volume 2 is here! This followup to his very 
popular collection of Apple tricks, gimmicks, and techniques 
contains still more high-quality information on how to get the 
most out of our favorite computer. Here Don provides the 
tricks of microjustification and proportional spacing for 
Applewriter //e, an absolute “Old Monitor” style RESET for the 
//e, a software-only video synchronization technique for all 
Apple II's and //e's, and a just-for-fun guide to mapping and 
playing Castle Wolfenstein. 


I've been saving the best for last: Tearing Into Applewriter 
//e. Here is 86 pages of priceless data on the internal 
workings of the most popular Apple Word Processor, including 
how to capture source code and customize it to your own taste. 
See our ad on page three for price and shipping. 


As you will notice from his ad in this issue, Lancaster has 
been hard at work tearing into Appleworks, and has a set of 
disks available on that program. We haven't seen those yet, 
but I'll bet they're more of the same great inside info we've 
come to expect from Don. 


A New Catalog for DOS 3-3 i~dws waa de €eb ewes RODELTC F. O'Brien 
Dublin, Ireland 


In AAL March ‘85 Bob S-C presented re-writes of some loosely 
coded DOS sections to make space for patches - the Catalog 
Function Handler is another such loose bit of code, but rather 
than just free up some bytes I decided to add some useful 
features which Apple omitted and correct an annoying error at 
the same time. This new routine adds the following features to 
the CATALOG command: 


l- Displays the free space remaining on the disk. 


2. Allows you to terminate the Catalog during the normal 
pause after a screenful of files have been displayed 
by pressing the <ESC>-key (or other designated key). 


3- Displays the correct number of sectors for each file 
in the Catalog for even the very large files - where 
the number of sectors exceeds 255 (which was the 
limit of the old PRINT.DECIMAL subroutine at SAE42 in 
DOS 3.3). 


4. Optionally displays two filenames on each line of the 
Catalog - this is an 80-Column card option, also great 
for double-barrelled CATALOG printouts (for labels 
etc.). 


In addition, the new Catalog retains the principal features of 
the old routine such as displaying the Volume number, the 
locked file indicator (*) and the file type abbreviation so 
that the user is not deprived of any essential information. 


All the foregoing was achieved without using any additional DOS 
RAM space or zero-page locations other than that space already 
used by the Catalog Function Handler itself. Of course, 
something of the old routine had to be sacrificed in order to 
add the new features - it was necessary to omit the message 
“DISK VOLUME “ from the beginning of the display. The 12-byte 
Space where this message resided is now used to house a 
subroutine to check for locked files. 


Even with all these enhancements, there are 17 free bytes left 
over! You could use some of them to print out an abbreviated 
form of the “DISK VOLUME “ message, like "v=". 


An additional constraint I saddled myself with in doing the 
re-write was that PRINT.DECIMAL (the DOS subroutine used to 
convert the hexadecimal numbers in locations $44,45 to decimal 
and print them) should retain its normal entry point (SAE42) so 
that the new code would be compatible with other programs which 
might use it. 


For those who wish to get double-barrelled Catalog listings on 
an 80-column card or on a printer just change the "SEC" at line 
2010 to “LSR*. In other words, $AE12:4A will enable the wide 
printout, and SAE12:38 will put it back to normal. 
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S-C Macro Assembler Version 260 6 4eo 5564 0 a SOS EEO OLOU 
Version 2.0 Upgrade Kit for 1.0/1.1/1-2 Owners... ccccccccccssecccceese e920 
Source Code for Version 1-1 (on two disk SideB) ..ccccccceccccccccveseSlI0 
Full Screen Editor for S-C Macro (with complete source code) .....++++-949 
S-C Cross Reference Utility (without source Code) ..ccccecsccececcccees 920 
S-C Cross Reference Utility (with complete source code).......cecccees 990 
DISASM Dis-Assembler (RAK -WALC) 64.44.4664 604.6655 006 066s 60 WEN DOO 4S ESRD OU 
Source Code for DISASM c4.4.04-5 6 6 08 66 0040S ON EOS EN SS es Cas EGU ECILONAlL $30 
S-C Word Processor (with complete source COde) ..coccccvccccvcccvecsccsceesIU 
DP18 Source and eles f (>| ee ee eee ee eee ee ee ee 
Double Precision Floating Point for Applesoft (with source code)......$50 
S-C Documentor (complete commented source code of Applesoft ROMs).....$50 
Source Code of //e CX & F8 ROMS On disk... .cccccccccccccecccccesesecseseolS 


(All source code is formatted for S-C Macro Assembler. Other assemblers 
require some effort to convert file type and edit directives.) 


AAL Quarterly DisSkS....ccccccccccccccccceee- each $15, or any four for $45 
Jan-Mar Apr-Jun Jul-Sep Oct-Dec 


Each disk contains 1980 = 

the source code from 1981 2 3 4 5 

three issues of AAL, 1982 6 7 8. 9 

saving you lots of 1983 10 ll 12 13 

typing and testing. 1984 14 15 16 17 
1985 18 


AWIIe Toolkit (Don Lancaster, SynergeticS) ..ccccccccccccsccccccvecscses 939 
ES-CAPE: Extended S-C Applesoft Program Editor (new price, was $60) $40 
“Bag of Tricks®, Worth & Lechner, with diskette.....cccceeee ($39.95) $36 


Blank Diskettes (Verbatim) .....ccccccccccccccecccece package Of 20 for $32 
(Premium quality, single-sided, double density, with hub rings) 
Vinyl disk pages, 6°x8.5", hold two disks each....cceccccceceeelO for $6 
Diskette Mailing Protectors (hold 1 or 2 disks).........+...40 cents each 
(Cardboard folders designed to fit 6°X9" Envelopes.) or $25 per 100 
Envelopes for Diskette MailerS....ccccccccccccccccccccccece 6 Cents each 


quikLoader EPROM System (SCRG) 6 i404 eeen wee 6 see eee eewtn een COLTS) $170 
PROmGRAMER USCRG) eaiis 6-80d6 is. 6o ee 66s We oe 26 oe oe ee eee ews 1 9149.50) $140 
D MAnual Controller (SCRG) sis os sees vsecee es escesenweseeee ss ce se< ($90) $85 
Switch-a-Slot (SCRG) ssa 6 sein ae 646 ow O6Nis Oat abe 6 Sew ea ee Sere wwe l OLO0) $175 
Extend-a-Slot (SCRG) a6e ene cae 366 os heen ke btw Sows bse kewe ee ewe west ooD) $32 


"Apple ProDOS: Advanced Features for programmers", Little..($17.95) $17 
*Inside the Apple //eo", Ditt less vswickiwiwesesee shee een ewewe (919.95) $18 
"Inside the Apple //e", Little..cc.ccccccccsccccccvccccvecvcece ($19.95) $18 
"Apple II+/IIe Troubleshooting & Repair Guide", Brenner.....($19.95) $18 
"Apple J{ Circuit Description", Gayler....ccccccccccvcccccee ($22.99) $21 
“Understanding the Apple II", Sather....ccccccccccccscccscees (9220.99) $21 
“Understanding the Apple //e", Sather...cccccccccccccccesecce ($24.95) $23 
“Enhancing Your Apple II, vol. 1%, Lancaster....cccccccceeee ($15.95) $15 
“Enhancing Your Apple II, vol. 2", Lancaster-..ccccccsccceee(Sl7-95) $17 
“Assembly Cookbook for the Apple II/IIe", Lancaster.........($21.95) $20 
“Beneath Apple DOS", Worth & LeChner....ccccccccccccccccsesee (919.95) $18 
“Beneath Apple ProDOS", Worth & Lechner... .cscccccccccccvees(Sl9.95) $18 
"6502 Assembly Language Programming", Leventhal......cseeeee ($18.95) $18 
"6502 Subroutines", Leventhal...cccccccccscccccccccvsececcese ($18.95) $18 
"Real Time Programming -- Neglected Topics", Foster....cccceee ($9.95) $9 
"Microcomputer GraphicS", MYErS..ccccccccccccccevcvccscccceee ($l2.99) $12 
“Assem. Language for Applesoft Programmers", Finley & Myers.($16.95) $16 
“Assembly Lines oe the Book", WAGNEL -ccccccccccccccccsccccce (919.95) $18 


Add $1.50 per book for US shipping. Foreign orders add postage needed. 
Texas residents please add 6 1/8 % sales tax to all orders. 
*#* S-C SOFTWARE, P. O. BOX 280300, Dallas, TX 75228 *** 


aan (214) 324-2050 wee 
*** We accept Master Card, VISA and American Express *** 
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To install the new patches just BLOAD the two binary friles: 
NEW CATALOG PART 1. and NEW CATALOG PART 2. You can put the 
modified DOS onto any normal disk using Bob Perkins' technique 
(in AAL Aug 1982 p.24) without disturbing any other files 
present. or INIT a blank disk and the modified DOS will be 
incorporated on it. If you prefer to terminate long Catalog's 
with the <RETURN> key as you do for listings with the S-C Macro 
Assemblers just change byte $AE21:8D. 


Also, if you are prepared to restrict yourself to 1l1 character 
file-names you can have a double-barrelled Catalog on the 
40-Column screen by changing byte SADF7:0B (POKE 44535,11), but 
I feel it would be of little value overall. 


Now for a more detailed look at the program internals. Due to 
the requirement to save as many bytes as possible to squeeze in 
the desired features it was not possible to write the code in 
as straight-forward a manner as one would like. Even so, the 
routine was written with 17 byte to spare - after many 
re-writes to fit in all the features. 


Lines 1020-1240 define various subroutines, variables, and data 
tables inside the rest of DOS. 


Lines 1320-1360 use the same code as the original Catalog 
routine to initialize the File Manager and read the disk Volume 


Table Of Contents (VTOC). 


In lines 1370-1410 we clear LINE.SKIP.FLAG which is used by 
SKIP.LINE subroutine to determine whether to tab to a second 
column or print a carriage return. Then we call 
PRINT.DECIMAL-.YA to print the volume number. The volume number 
itself is passed in the A-register, and a zero high-byte in Y. 
Since we stripped out the code for printing “DISK VOLUME “, the 
volume number will be printed immediately to the right of the 
CATALOG command, on the same line. You will see “CATALOG 254 
395", or the like, where the first number is the volume number 
and the second is the count of free sectors. 


By making a special entry above the PRINT.DECIMAL subroutine 
which is used both here and at line 1830 below, we save several 
bytes. Of course we have already save a couple dozen bytes by 
not printing “DISK VOLUME "“. 


Calculation of the free disk space is made in lines 1420-1530. 
We make use of a new feature in the corrected PRINT.DECIMAL 
routine whereby $44 and $45 are reduced to 0 during the 
conversion - resulting in a saving of 4 bytes by not having to 
re-zero $45. (In the old routine only $44 was reduced to 0.) 


In the VTOC 4 bytes are set aside for each track to indicate 
sector usage although only 2 are needed for a standard Apple 
disk. (The extra space allows up to 50 tracks and up to 32 
sectors per track to be initialized.) A bit set=l means that 
the corresponding sector on the track is available for use. If 
a bit is set=0 then the sector is already allocated. So it was 
simply a matter of counting every bit set from offset byte $38 
(track 0) to Byte $C3 (for Trk $22) of the VTOC buffer to get a 
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NEW DON LANCASTER RELEASES 


Available ONLY from Synergetics. All software open and unlocked. 


ABSOLUTE RESET (IlIc/old Ile/new Ile) ............0c0000 $19.50 


Get back in total control. No more hole blasting! Access any part 
of any program at any time for any reason. Passes all diagnostics. 
Invisible till activated. Includes EPROM burner adapter details, 
service listings, and a free bonus book. 


APPLEWRITER™ Tle TOOLKIT ............ ccc ceceece ee $39.50 


EIGHT diskette sides include a complete disassembly script, self- 
prompting glossaries, Diablo microjustify and proportional space, 
patches for NULL, shortline, IIc detrashing, answers to lots of 
help line questions, source code capturing, two columns, WPL 
secrets, space on disk, keyword indexing, more. 


ProDOS APPLEWRITER™ 2.0 TOOLKIT ............... $39.50 


Another EIGHT diskette sides crammed full. Includes a neat 
automatic source code capturer, a complete disassembly script, 
dozens of patches, prefix hassle fixes, Grappler and shortline 
repairs, NULL diversion, two columns, auto indexing, plus Don’s 
unique self-prompting glossaries, Diablo microjustify, etc. 


Both TOOLKITS: o:i4200605000s0dssosw sok acces tedete eu fO9-50 


APPLEWORKS™ DISASSEMBLY SCRIPT .............+. $49.50 
TEN diskette sides chock full of Applework’s innermost secrets, 
using Don’s unique and powerful "tearing method". Primarily 
for gonzo hackers and definitely NOT for the faint of heart. 


COMPANION DISKETTES: 


For Enhancing Your Apple II, Volume I 
For Enhancing Your Apple II, Volume II 
For Don Lancaster’s Assembly Cookbook 


ASSORTED GOODIES: 
VAPORLOCK instant sync package 
Old Fangled Animation demo 
The Incredible Secret Money Machine (autographed) 
Laserwriter/Applewniter Utilities Package 


SYNERGETICS 


746 First Street 
Box 809-AAL VOICE HELPLINE 


Thatcher, AZ, 85552 (602) 428-4073 


VISA and MASTERCHARGE accepted. Please - no COD, foreign, or purchase orders. 
Appleworks, Applewriter, and ProDOS are registered trademarks of Apple Computer. 
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count of the free space. If you want to count all the way to 
the 50th track, in case the program is working with a hard disk 
like the Sider or Corvus, or a RANA 320K floppy, change lines 
1430-1440: 


1430 LDX #$38 
1440 LDA VTOC.BUFFER,X 


In line 1550 we have another departure from the original code - 
2 bytes were saved by entering the tail end of the SKIP.LINE 
subroutine in order to set the number of lines to place on the 
screen before pausing during a Catalog. This has the added 
advantage that you can customize your Catalog more easily in 
that the line count can be adjusted by modifying a single byte 


At lines 1570-1610 we start by clearing the Carry flag so that 
the first sector of the directory will be read (track $1l, 
sector SOF). Also we set the index (X) to the first filename 
entry in the sector. 


Lines 1620-1660 examine the track number of the Track/Sector 
list for the current filename entry. Should this number be 0 
it indicates that we are at the end of the directory, at which 
point we would terminate the Catalog by exiting the File 
Manager routine by a jump to $B37F. 


Fortunately, there was a JMP S$B37F instruction within relative 
branching distance of the Catalog Function Handler. We could 
therefore dispense with the JMP to $B37F in the original code 
saving a further 3 bytes by branching to FM.EXIT at SAD86 
instead. This is an address in the DELETE Function Handler 
(SAD2B-AD97) which precedes the Catalog routine in RAM. There 
are three ways we can terminate the Catalog, which all result 
in a branch to FM.EXIT: here at line 1600 when we find there 
are no more catalog sectors, at line 1650 when we find there 
are no more catalog entries, and at line 2090 when the ESC-key 
is typed during a screen-pause. 


At line 1660 if the track number value is negative (bit 7 set) 
then we have found a deleted file. Deleted files don't show up 
on the Catalog, so we call on the subroutine at $B230 which 
sets the X-Register to the value of the entry point offset for 
the next entry in the sector. if any. 


If on return from this subroutine the Carry flag bit is set 
(=1) then we have reached the end of the current catalog sector 
and we branch back to READ.SECTOR at line 1580 to read the next 
directory sector, if any. (Each directory sector accommodates 
7 entries.) 


At line 1680 we call the SKIP.LINE subroutine, which normally 
merely prints a carriage return. This routine was called from 
five different places in the original catalog code, so we have 
saved a dozen bytes by only calling it from this one place. 
(Putting it in-line would save four more!) 


At line 1700 we call the new subroutine at the site of the DISK 
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VOLUME message space to check for locked files and print the © 
space or asterisk. This routine also leaves the file type code 
in the Y-register This code could be placed in-line. rather 
than making it a subroutine, but then the final two lines could 
not be used as a short PRINT.SPACE subroutine. 


Lines 1710-1790 convert the file type code to a file type 
Character. The file type code is in bits 6-0, and is either 
zero (meaning type T), or a single bit. The hex values 40, 20, 
10, 08, 04, 02, and 01 stand for file types B, A, R, S. B, A, 
and I. A string at $B4C8 holds “TIABSRAB", so we need to 
convert the bit position to an index value. and pick up the 
character out of that string. The ASL at line 1740 elminates 
the “lock/unlock” bit. The loop in line 1750-1770 shifts bits 
out until the value is zero, counting up in the Y-register. If 
the value was already zero, we exit immediately with Y=0, and 
type is “T*. A type value of 1 gives an index of 1. up through 
$40 giving an index of 7. 


By the way, types 40 and 20 are not Binary and Applesoft. They 
are hardly ever used, except in protection schemes. Types 04 
and 02 are Binary and Applesoft. 


The original catalog code had a significantly longer loop for 
converting the file type number to an index. You might want to 
compare the two. 


The number of sectors in the file is picked up and converted in 
lines 1800-1830 and the decimal value is printed, surrounded by 
Spaces. Lines 1840-1900 print out the file name. 


Lines 1920-1950 advance to the next filename entry, and branch 
either to process it or to read in another catalog sector. 


Lines 1970-2130 usually print a carriage return. If you have 
changed line 2010 to “LSR“, to get double column catalogs, the 
least significant bit of LINE.SKIP.FLAG will determine whether 
to print a carriage return or not. When line 2010 is “SEC” we 
will always get a carriage return. If a carriage return is 
printed, we also count the line. When the line count is 
complete, we pause and wait for a keystroke. If that key is an 
ESC-key, the catalog will terminate. If not, the line count is 
re-initialized and we go back for more file names. 


Line 2150 simply reserves 17 bytes, shoving the PRINT.DECIMAL 
routine down so that it still starts at S$AE42 like it used to. 
These 17 bytes could be used for other code or data, whatever 
you like. 


Lines 2160-2230 store a value to be converted and printed, 
print a blank, and then fall into the PRINT.DECIMAL subroutine. 


The new corrected PRINT.DECIMAL subroutine is actually a little 
shorter than th buggy original. It left room for a JMP 
PRINT.SPACE at the end, which saved calling PRINT.SPACE from 
several other places. It also left room for the LINE.SKIP.FLAG 
variable. 
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The PRINT.DECIMAL subroutine (lines 2240-2490) effectively 
divides the number in $44,45 by subtracting in turn the values 
100, 10 and 1 from it - a 16-bit subtraction. The count of the 
number of subtractions and the low order byte remainder are 
temporarily stored on the stack to conserve memory usage. We 
Start with 100 and keep subtracting it and incrementing the 
subtraction-counter until we get borrow, at which point we 
print the counter value. 


Now $44,45 will contain the remainder and so we continue using 
10 and then 1 until three decimal digits are printed. This 
subroutine can accurately convert numbers having values up to 
999 decimal. 


CHALLENGE. Even though we have already squeezed out 17 bytes, 
while adding new features, we did lose the “DISK VOLUME “ 
message. Can someone out there squeeze enough more out, 
without losing any features, to slip the message back in? 


CAVEAT. If you decide to put this new CATALOG program on your 
disks, please be careful. There are some programs which 
temporarily patch the catalog routine themselves. In 
particular, ES-CAPE and other commercial programs patch the 
SKIP.LINES subroutine so that the pause is eliminated. Since 
SKIP.LINES has been moved and is different. no telling what 
might happen. 


WARNING! 


Some of Applied Engineering’s Products are 
being sold by non-authorized dealers. 


To insure your warranty, to receive upgrades and 
to obtain technical support, please buy direct from 
Applied Engineering or an authorized dealer. 


Be suspicious if: 
1) The dealer is mail order. 
2) You don't know the dealer. 
3) The product is not in stock. 
If you’re not sure about a dealer, please call us. 


(214) 241-6060 


A 


APPLIED ENGINEERING 
“We Set the Standard” 
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goAVE S.-NEW CATALOG 
DOS. ARITH . REG ~EQ $44, 45 
ADV. NEXT. DIR. ENTRY -EQ $B230 
DOS . INIT .FM EQ $ABDC 
EXIT.FM ~EQ $AD86 
MON . COUT EQ $FDED 
MON . CROUT ~EQ $FD8E 
MON . RDKEY ~EQ $FDOC 
READ.DIRECTORY.SECTOR .EQ $B011 
READ. VTOC EQ $AFF7 
DEC.CONVERSION . TABLE ~ EQ ire 
FILE. TYPE. NAME. TABLE eEQ $B3A7 
CATALOG. LINE .COUNT ~EQ $B39D 
DIRECTORY. ENTRY ~EQ $B4C6 
DIRECTORY. INDEX ~EQ $B39C 
DISK. VOL.NUMBER -EQ $B7F6 
FILE. NAME ~-EQ $B4C9 
FILE.SIZE EQ $BHE 
FILE. TYPE ~EQ $BAC 
FM. VOL. NUMBER ~-EQ $B5F9 
VTOC . BUFFER ~EQ $B3BB 
8 New Catalog for DOS 3.3 
: by Robert F.O'Brien 
~OR $AD98 
~TF NEW CATALOG PART 1 
CATALOG 
JSR DOS.INIT.FM Init file manager. 
LDA #$FF Set Volume = 0 
STA FM.VOL.NUMBER (matches any volume) 
JSR READ.VTOC Load in VTOC into buffer. 
#.-=-Print Volume Number---------- 
LDY # High byte = 0 
STY LINE.SKIP.FLAG (signal to skip) 
LDA DISK.VOL.NUMBER low byte 
JSR PRINT.DECIMAL- YA 
#.--Calculate Free Space--------- 
LDX 1b ark Q VTOC offset 
1 LDA VTOC.BUFFER+$38—-$74 ,X Bit Map Byte 
22 BPL . This sector in use 
aE DOS. ARITH. REG Count a free sector. 
INC DOS. ARITH.REG+1 
3 ASL Check next bit 
BNE .2 Still more in this byte 
4 INX Next byte of bit map 
BNE .1 eeeStill more 
JSR PRINT.DECIMAL print number free 
#-<<Start Line count-<“<<-<-<ex2<<<---= 
JSR SET.LINE.COUNT lines to print. 
#.--Start reading directory------ 
CLC Get first sector. 
READ. SECTOR 
JSR READ.DIRECTORY. SECTOR 
BCS EXIT.FM No more sectors 
LDX #0 Index to Ist file in sector 
SET. ENTRY. INDEX 
STX DIRECTORY.INDEX Set entry offset 
LDA DIRECTORY. ENTRY,X See if valid filename 
EXIT BEQ EXIT.FM «e-end of rabeae 
BMI NEXT. ENTRY -.eignore deleted file. 
#~--Start next file display------ 
JSR SKIP.LINE Next line or Tab 
#..-Locked or Unlocked-------<---- 
R LOCKED. FILE.CHECK w#e if locked file. 
B.meFile Typeqnnnenen mene ene nnne 
TYA Get file type byte 
LDY #-1 Index to type table 
ASL Ignore Bit 


ADE3- 68 nea | INY Next file type 
ADE4- 1760 LSR Hees pas Puce. byte 
ADE5—- DO atte BNE .1 ee -Nod ey 
ADE7—- BS A7 B3 1780 .2 LDA FILE. TYPE.NAME. TABLE,Y Get file type 
ADEA- 20 1730 JSR Pale CouT ---and "print it 
1 0 toile 2p GP Ge GE Gs Ge OD GR Oe ED GD SDS GS OP OD ae OS OP 
ADED- BC E8 B4 1810 LDY FILE. steele high order byte 
ADFO- BD E7 B4 1820 LDA FILE.SIZE,X low order byte 
ADF3- 20 3B 1830 JSR PRINT. DECIMAL. YA print total sect. 
1840 #---File Name-------------------— 
ADF6— AO 1 1850 LDY #30 
ADF8- BD C9 B4 1860 .3 LDA FILE.NAME .X char. no. in Y. 
FB= 20 ED FD 18718 JSR MON.COUT print file name. 
ADFE- F 1880 INX next char. 
ADFF- 1890 DEY 
AEOO- DO F6 1900 BNE .3 not done yet! 
1336 #.--Next File in Directory-<----- 
1920 NEXT.ENTRY 
AEQ2- 30 Be 1330 JSR ADV.NEXT.DIR.ENTRY Set X-Reg for next file 
AEO5- 90 C8 1940 BCC SET. ENTRY. INDEX more in sector 
AEO7- BO BF 3 7 ; BCS READ. SECTOR get next sector 
110 SKIP. LINE 
AEO9=- 20 B6 B3 1980 JSR PRINT.SPACE sa SE 2nd line entry 
AEOC- EE 89 AE 1990 INC LINE.SKIP.FLAG lsbit 
AEOF- AD AE 2000 LDA LINE.SKIP.FLAG Check Odd or Even 
AE12- 38 2010 SEC <<<Change to "LSR® Ry double 
2020 # column CATALOG >>> 
AE13—- 90 14 2030 BCC RETURN 
AE15= 20 SE FD 2040 JSR MON .CROUT Start a new line 
AE18—- CE 9D B3 Saka DEC CATALOG. LINE.COUNT continue countdown 
AE1B=- DO OC 2060 BNE RETURN not full screen yet 
AE1D=- 20 OC FD 2070 JSR HON 5p RDKEY Pause for keypress! 
AE20- C9 9B 2080 CMP #$9B Is it ESC-key? 
AE22- FO B1 2090 BEQ EXIT ee. yes, exit file manager 
2100 SET.LINE.COUNT 
AE2H- AQ 15 2110 LDA #21 lines per screenful 
AE26- 8D 9D B3 2120 STA CATALOG. LINE.COUNT 
AE29- 60 | ee RETURN RTS _Continue catalog 
AE2A- a : F -BS 17 "7 FREE BYTES! 
2170 * Print (YA) with leading and 
5; : trailing blanks. 
5380 PRINT. DECIMAL. YA 
AE3B- 84 4 2210 STY DOS. ARITH. REG+1 
AE3D=- 85 4 2220 STA DOS. ARITH. REG 
AE3F- 20 B6 B3 e230 ; JSR PRINT. SPACE 
. & ~ Print ($44,45) with trailing blank 
2270 PRINT.DECIMAL 
AEH2- AO 02 2280 LDY #2 Set for 3 divisors 
AE4X—- AS BO 2290 .1 LDA #$BO0 ASCII zero 
AEN6—- 4 2300 .2 PHA save digit on puece 
AEYT—- 32 2310 SEC Subtract 100, 10. or 1 
AENB- A5 44 =. 2320 LDA DOS.ARITH-REG from remainder 
AEHA- FQ A B3 2330 SBC DEC.CONVERSION . TABLE, Y 
AEND=- 4 2340 PHA save remainder on stack 
AENE- A5 45 2350 LDA a aa all 
AE50- EQ 00 2360 SBC #0 divisor high byte = 0) 
AE52- ge OA 2370 BCC .3 eeefar enough 
ne 3 45 23 . oy DOS.ARITH.REG+1 Update remainder 
AE5T= Be uy 2400 STA DOS. ARITH. REG 
AE59=- 68 2410 PLA get current digit 
AE5A- 69 00 2420 ADC #0 and count the subtraction 
AE5C- re E8 oi30 BNE .2 continue subtracting 
AE5E- 24hO .3 PLA Discard stacked remainder byte 
AE5F- 68 2450 PLA Get quotient digit 
AE6GO- 20 ED FD 2460 JSR MON -COUT and print it! 
AEG 3- 88 ays DEY Next divisor 
AEO4- 10 DE 24 BPL . -- not finished yet 
AEOO=- 4C BO B3 rar JmP PRINT -OPACE Trailing space 
AE69- 00 $238 § LINE.SKIP.FLAG .DA #0 LEAST SIGNIFICANT BIT IS FLAG 


Page 10.....Apple Assembly Line......May, 1985......Copyright (C) S-C SOFTWARE 


2530 -OR $B3AF 
2540 P ~TF NEW CATALOG PART 2 


3 68 8 OVERLAYS "DISK VOLUME ” MESSAGE 
= 19 ; 2580 LOCKED. FILE . CHECK 

B3A 

Bap Ia cb By 2 60 LDY FILE.TYPE,X file type co 
Het 50 6 2610 BMI CAT.COUT --ethe file = "locked 
paos- ag ao 3698 TASER, 

sill Seka CAT. COUT 
B3B8- 4C ED FD 2650 , JMP MON .COUT 


80-Column Window Utility for //e and //c........«e.-Bill Reed 
New Orleans, LA 


I throughly enjoyed “Fast Text Windows" by Michael Ching. 
However, I prefer not to use the area at $800-BFF as a text 
buffer; I much prefer to use the first bank of the language 
card, which is not normally used by Applesoft programs running 
under DOS 3 3 


I modified Mike's program by changing the immediate values in 
lines 1560 and 1580 from #$0C to #$D4 and adding lines 1644, 
1646 and 1905. The first two lines enable the bank of RAM to be 
read or written to. The last re-enables the Applesoft ROMS. 


1644 LDA $CO8B 
1646 LDA $CO8B 
1905 LDA $C082 


I further modified the program to function in 80 columns on a 
//e or //c. The big problem was to mimic the text card, which 
uses bank switching to store adjacent characters in the same 
address, but different locations (main RAM and aux RAM). This 
was solved by using one buffer for the “even” characters and 
another for the “odd”. 


Additional code was required to determine the even/odd 
condition, so I (being lazy) removed the border portion of the 
program to conserve room The border routines could certainly 
be retained if part of the program was also moved to bank one 
of the language card area (Be careful if you try this, 
because you must avoid calling the monitor or Applesoft ROMs 
when the ROMs are switched off. You can possibly get away with 
calling the monitor with the ROMs switched off, but only if you 
first make a copy of the monitor in the F800-FFFF area of RAM.) 


I moved the data storage to the zero page, mostly because it 
was available and slightly faster. 


1000 *SAVES.WINDOWS .80 
1010 #=-AAL APRIL 85 P 16------------- 
1020 ~OR $2F5 
Heh -TF B.WINDOWS.80 
1040 Snenmnwwmewee ewe w ewww ew oww own oe 
00- tee P ~EQ $00 $0-$6 DATA 
O1- 1060 BOTTOM «EQ 
02- Jobe FT EQ $02 
03- 1080 RIGHT ~EQ $0 
04- 1090 WIDTH ~EQ $0 
05- 1100 LINE «EQ 305 
06—- 1110 DIREC ~EQ $06 
1120 
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Why Are Apple Owners 
So Loyal? 


eople who have the best often are, but in 

the case of Apple there's more. Apple own- 
ers think back to how Apple got started in 1977, 
just two people working out of a garage and what 
happened is the talk of Wall Street and the 
computer industry as well. Many like the fact that 
Apple only makes computers. Unlike their compe- 
tition, they don't make typewriters, copiers or 
telephones. They do just one thing and that’s one 
reason they do it so well. 


At Applied Engineering we think the same way. 
You see, Applied Engineering is the only major 
hardware manufacturer totally dedicated to the 
Apple computer. Whereas most of our competitors 
must divide their customer support and engi- 
neering time between IBM, Atari, Radio Shack 
or other computers, our engineers only design 
products for the Apple. This dedication allows us 
to be much more familiar with the Apple and 
those who use them. 


We don’t expect you to buy an Applied 
Engineering peripheral on loyalty alone, but 
when you compare our products to those made 
by QUADRAM, MICROSOFT, AST and others you'll 
find out why Applied Engineering means a 
quality design, innovation, craftsmanship and 
total Apple compatibility. 


The other guys do pretty well considering how 
busy they are with IBM. But at Applied Engineer- 
ing, ALL of our work involves the Apple. In fact, 
all of our employees were Apple owners before 
they came to work for us. The people in 
shipping, engineering, quality control, order entry, 
all use Apples at work and at home. 


This one track mindedness of ours allows us to 
offer the largest storage with AppleWorks and 
Visicalc and our Z-80 card now includes the new 
4.0 operating system. We can expand the Apple Ile 
to over 1 MEGABYTE of memory and we've got 
clock cards, music cards, A to D converters, digital 


controllers, and a BSR system so your Apple can 
control your whole house with no additional 
wiring! 


Applied Engineering recognizes that we've got 
to do a better job than our IBM counterparts 
because we know you're smarter than the 
average computer buyer, you bought an Apple. 
You see, Our competition has it a little easier, 
their customers aren't as smart as you. After all, 
they bought the wrong computer. 


So if you need more memory, or 80 columns, 
or RGB color, double hi res graphics, if you want 
to know the time and temperature or other “real 
world” conditions, if you'd like to run CP/M 
software, 68000 software, have a RAM disk, 
increase the storage of AppleWorks or Visicalc, if 
you want your Apple to play music, talk and sing, 
if you'd like your Apple to control the lights and 
appliances in your house, then do what NASA 
does, what Ford does, what the U.S. Government, 
Hughes Aircraft, Honeywell, Westinghouse, AT&T, 
and even what Apple computer does. Call Applied 
Engineering. Then you will discover what: 
thousands of companies and tens of thousands of 
Apple owners already know, that you can be 
smart and loyal all at the same time. 


We Set the Standard 


APPLIED ENGINEERING 
(214) 492-2027 


For information and specifications on Applied 
Engineering’s line of Apple peripherals, please see 
our ads in this magazine. Prices are given. 
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APPLIED ENGINEERING 


To a World of Compromise, We Make No Contribution 
THE NEW TIMEMASTER I! H.O. 


@ Absolutely, positively, totally PRO-DOS and DOS 3.3 and PRO-DOS versions of Apple 
DOS 3.3 compatible. Writer He. 
@ Time in hours, minutes, seconds and milli- bess x a o @ Appleworks will now time and date stamp 


all your data automatically. 

@ Compatible with ALL of Apple’s languages. 
Many sample programs for machine code, 
Applesoft, CP/M and Pascal on 2 disks. 

@ On-board timer lets you time any interval 
up to 48 days long down to the nearest 
millisecond. 

@ Rechargeable nickle-cadmium battery will 
last over 20 years. 


seconds (the ONLY PRO-DOS compatible 
card with millisecond compatibility). 

@ 24 hour military format or 12 hour with 
AM/PM format. 

@ Date with year, month, day of week and 
leap year. 

@ Eight software controlled interrupts so you 
can run two programs at the same time 
(many examples are included). 


@ The only card recognized by both the @ Two BSR/serial ports for future expansion. 
reo-005 INCLUDES SATLLISEC OND yeaa CARCEST SAMPLE atmo ose UAULATES alt 
COMPATIBNL DOS DaTtR Tit Oala sorrwaal $47 PORT oat OTHER CLOCKS 
“uO wes vet wes vis vas wes vis ves 
BRAND A NOP xO) vis NO sO NO Nw SO 
SMAND NOD SO NO NO “0 NOD NO NO 
BRAND St “0 NO sO SO AQ xO sO NO. 
BRANT) © Libs ves NG vhs sO sO NO NO 
QRaNt) Ss NO SO sO Ws wo NO NO NO 
BkaAND T ws nO NOD NO nO NO wis NO 


Full emulation of all other clocks. Yes, we emulate Brand A, Brand T, Brand P, Brand C, Brand S and Brand M too. It’s easy for the H.O. to 
emulate other clocks, we just drop off features. That’s why the H.O. can emulate others, but none of the others emulate us. The Timemaster 
1! H.O. will automatically emulate the correct clock card for the software you're using. You can also give the H.O. a simple command to tell it 
which clock to emulate. This is great for writing programs for those poor unfortunates who bought some other clock card. 


REMOTE CONTROL 
Our BSR X-10 interface option for the H.O. allows you to remotely control up to 16 lights and electrical appliances through your BSR X-10 
home control system in your home or office. You're already wired because a BSR system sends its signals over regular 120 volt wiring. That 
means you can control any electrical device in your home or office without additional wiring. 

PRICE $129.00 BSR Option (may be added later} $49.00 


VIEWMASTER 80 Z-80 PLUS 
Now Includes New 4.0° Software 
There used to be about a dozen 80 column cards for the Apple. Enter the CP/M world with the new Z-80 Plus card from Applied 
Now there is oaly ONE. Engineering and introduce your Apple to thousands of new 


programs. Only the 2-80 Plus comes standard with the new 4.0 
software, the most advanced system for running CP/M programs 
ever. Only CP/AM 4.07 has advanced features like built-in disk 
emulation for popular memory expansion boards (those made by 
Apple and Applied Engineering and others) to give you a faster 
system with more storage. You also get menu driven utilities that 
are much easier to use than the older CP/M utilities so you can 
get down to all that great CP/M software faster. If you already 
own the Z-80 Plus, you can upgrade to the 4.0 software for only 
$29. The Z-80 Plus runs older CP/M programs too, down to 
Version 1.6 (2.2 is the most popular). With the Z-80 Plus y6u can 
run the largest body of software in existence. Simply plug the Z- 
80 Plus into any slot in your Apple. You'll have two computers in 
one and the advantages of both, all at an unbelievably low price. 
@ TOTALLY compatible with ALL CP/M software. 


@ TOTALLY Videx Compatible. : 

@ 80 characters by 24 lines, with a sharp 7x9 dot matrix. 

@ On-board 30/89 soft video switch with manual 40 column 
override. 

@ Fully compatible with ALL Appie ianguages and sottware—there 
are NO exceptions. 

@ Low power consumption through the use or CMOS devices. 

@ All connections are made with standard video connectors. 

@ Both upper and lower characters are standard. 

@ All new design (using a new Microprocessor based C.R.T. 
controller) for a beautiful razor sharp display. 

@ The VIEWMASTER incorporates all the features of all other 80 
column cards, plus many new improvements. 


TNT somite Stream “ousicw” moat” satan “inputs” “ovtemoe. coauacties @ The only 2-80 card with a special 2K “CP/M detector’ chip. 
Pa se. oe = om ee one ie a si @ Fully compatible with microsoft disks (no pre-boot required). 
Guinier. autim ' Baie vs Se xo a an a ay @ Specifically designed for high speed operation in the Apple Ile 
milimuaviae’=< aE a i ey ma as are 6A a (runs just as fast in the tl+ and Franklin). 
ine nat Be a 1 on is ai wo me @ Runs WORD STAR, dBASE tl, TURBO PASCAL, FORTRAN-8O, 
PEACHTREE and ALL other CP/M software with no pre-boot. 

The VIEWMASTER 80 works with all 80 column applications @ A semi-custom |.C. and low parts count allows the Z-80 Plus to 

including CP/M, Pascal, WordStar, Format II, Easywriter, Apple fly thru CP/M programs at a very low power level. (We use 

Writer II, VisiCalc, and all others. The VIEWMASTER 80 is THE the Z-80A at a fast 4MHZ.) 

MOST compatible 80 column card you can buy at ANY price! @ Does EVERYTHING the other Z-80 boards do, plus Z-80 

PRICE $139.00 interrupts. PRICE $139.00 
SUPER MUSIC SYNTHESIZER — END MOCKINGBOREDOM 

@ Complete 16 voice stereo music synthesizer on one card. Just programs, 2 disks are filled with over 30 songs ready to play. 
plug it into your Apple. connect the audio cable (supplied) to @ Easy to program in Basic to generate complex sound effects. 
your stereo, boot the disk supplied and you are ready to input and Now your games can have explosions, phaser zaps, train 
play songs. whistles, death cries. You name it, this card can do it. 

@ It's easy to program music with our compose software. You will @ Four white noise generators which are great for sound effects. 
start right away by inputting your favorite songs. The Hi-Res @ Full control of attack, volume, decay, sustain and release. 
screen shows what you have entered in standard sheet music @ Our card will play notes from 30HZ to beyond human hearing. 
format. @ Automatic shutoff on power-up or if reset is pushed. 

@ Now with new improved software for the easiest and the fastest @ Many many more features. 
music input system available anywhere. @ Works in any slot of a Ile or Il+ including slot 3 of a He. 

@ We gives you lots of software. Jn addition to Compose and Play PRICE $159.00 


Our boards are far supertor to most of the Consumer electronics made todas AIELC (sare in high quality sockets with ma-spec. Components used throughout. PC, boards are glass-epoxy 
with gold contacts. Made in Amesica to be the bestin the world. All products work in Apple He, TE TEs aod Franklin, Applied Engineering abo manufactures a full line of data acquisition and 
control products for the Apple: A/D converters and digital /O cards, etc Please call tor more intormation Albour products are fully tested with complete documentation and available lor 
immediate delivery. All products are guaranteed with a no hassle THREE YEAR WARRANTY. 


Call (214) 492-2027, 9 a.m.to 11 p.m. 7 days aw eek orsend check ofrmoney order to P.O. Box 798, C arroilton, Texas 75006. MasterCard, Visa and 
APCLIED ENGINEERING (.0.D. welcome. No extra charge for credit cards. Texas residents add 5%% sales tax. Add $10.00 if outside U.S.A, 
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18- 1130 B1 -EQ $18,19 TEXT PNTR 
1A- 1140 B2 .EQ $1A,1B BUFR PNTR 
1C- 1150 B3 .EQ $1C,1D BUFR PNTR 
20~ 1160 WNDLFT .EQ $20 
21- 1170 WNDWDTH .EQ $21 
22 1180 WNDTOP wEQ $22 
23- 1190 WNDB1M .EQ $2 
28- 1200 BASL : 2 
29- 1210 BASH «EQ $29 
ORF = 1230 AMPE .EQ 35 
CO54q- 1240 PAGZOFF .EQ $C054 READ MRBRD 
C055~ 1250 PAGZONN .EQ C055 READ AUXBRD 
c0b2- 1260 LCR ~EQ $C082 
COBB- 1270 LCRAM1 ~EQ $C08 
E6F8- 1280 GETBYTE .EQ $E6F 
E74C- 1290 COMBYTE .EQ $E74C 
FBC1- 1300 BASCALC .EQ $FBC1 
FC58- 1328 HOME ~EQ $FC58 
1330 SETUP 
O2F5= A9 0 1340 LDA #MOVE.WINDOW 
O2F7- 8D F6 03 pF 0 STA AMPERV+1 
O2FA- AQ 0 1360 LDA /MOVE.WINDOW 
gare: eB FT 03 181 gag anes 
1900 Saceseo case ccs cesecccceseewnces 
i 0 MOVE. WINDOW 
0300- 20 F8 E6 1410 JSR YTE 
ge ig 8 eg BT 
0307- 20 NC ET infty JSR COMBYTE 
O30A- 86 01 1450 STX BOT 
030C= 20 4C E7 1460 JSR COMBYTE 
O30F- 86 0 1470 STX LEFT 
0311- 20 4C BT 14 JSR COMBYTE 
Osiés ep? dado Wk on 
OR tke ga 1230 rid 
0319- E5 02 1530 SBC LEFT 
031B- 85 O4 15 STA WIDTH 
031D=- 20 AC E7 1550 JSR COMBYTE 
0320- CA 1560 DEX 
0321- 86 06 1570 . STX DIREC 
1 eae ae ne ne NE Ae ee eee 
1280 MOVE. LINE 
0323- A5 05 1610 LDA LINE 
0 2 - 20 cI FB 1620 JSR BASCALC 
rae fe i8 1970 STA B1+1 
come ts 
- + 
O- CLC 
31 b6 04 1928 ADC #$04 2ND BUFR 
0333- 85 1D 1690 STA B3+1 
sac ewes ak aS 
0339- 1A 1720 STA B2 
033B- 85 1C 1730 STA B3 
033D- AD 8B CO 1740 LDA LCRAM1 ENABLE LANG 
0340- AD 8B CO 1750 LDA LCRAM1 CARD R/W 
gas as 03 149 MOMEDsME a SECRET 
0345- 4A i750 A/2 + EVN/ODD 
0346= A8 17.90 TAY TXT SCRN PNTR 
0347= A6 06 1800 LDX DIREC 
0349- DO 1B 1810 BNE 
1820 #--MOVE ae eee eee eee 
O34B- A6 O4 1830 LDX WIDTH DOWN COUNTER 
034D= 90 Of 1840 BCC .2 
O34F=- B1 1 1850 .1 LDA B1}.¥ DO ODD COLS 
gi a hag ge (Be) 
O32 = 30 29 1349 BMI .6 
0356- AD 58 CO 1890 -2 LDA PAG2ZONN DO EVN COLS 
0359- Bi 1 1960 LDA (BI /Y 
035B- 91 1¢ 1910 STA B3 Y 
035D- AD 54 co 1920 LDA PAG2OFF 
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0361- CA 1940 DEX 
0362- 10 EB 1326 BPL . 
1970 #=--MOVE IT DOWN--cnomn nnn nn === 


O368- 20 9 3388, 24 BBA 3B2),x DO ODD COLS 
0 STA (B1),¥ 


036C- 9118 201 A 
O3 ey SS og 3030 BMI .6 
Q Fe e 
0371- ip 55 cO 2030 .5 +s LDA PAG2ONN DO EVN COLS 
0374- B1 1C 2050 LDA (B3),Y 
HE paar i co 2070 oth BAG2OFF 
osiBe fb sob0 DEY 
037C~ CA 2090 DEX 
037D- 10 EB 2100 BPL .4 
2110 &.-NE XT LINE sane neraneanauveaerenen 
037F- E605 2120.6 INC LINE 
0381- AD 82 CO 2130 LDA LCROM RESTORE ROM 
O384- A501  ©«=218O LDA BOTTOM 
0 B6- C5 05 2150 CMP LINE 
0388- BO 99 83=._ 2160 BCS MOVE.LINE 
2170 ®.-IF CLEARING, SET WINDOW—---- 
038A- AS 06 2 3=—_ 2180 LDA DIREC 
038C- DO 15 = 2190 BNE .7 
O38E- A6 02 2200 LDX LEFT 
0390- 86 20 2210 STX WNDLFT 
0392- A6 0% ©2220 LDX WIDTH 
0304- cA 2230 DEX 
0395- 86 21. += 22 STX DTH 
0397- A6 00 © 2250 LDX TOP 
0399- E8 2260 INX 
039A- 6 22 2270 STX WNDTOP 
039C- Ab 01 «= 2280 LDX BOTTOM 
039E- 86 23 2290 STX WNDBT™M 
gee, a 
$348 b W22 ee eeaeeeeeneconenanans 


AUTO/MANUAL Toggle Update for .........+eeeeeeeRObert F. O'Brien 
S-C Macro Assembler Version 2.0 . Dublin, Ireland 


Here is a short routine (23 bytes) which makes use of the ESC-U 
command option to toggle the Auto-linenumbering mode on and off 
readily. The routine is relocatable so you can put it anywhere 
you have sufficient free space - just set the ESC-U vector to 
point to it, in this case :$C083 C083 DOO0C:4C 00 03 N C080. 


When the cursor is waiting for input at the beginning of the 
command line, typing ESC-U will generate the command AUTO and 
then you have the option of entering a line number and/or 
RETURN. To cancel the AUTO mode just type ESC-U while the 
cursor is at the beginning of the line (just after the 
linenumber - 4 or 5 digit line numbers are catered for). 


Extended AUTO command: 


The second routine, starting at $317. is just 17 bytes long and 
extends the AUTO command so that you can specify the increment 
after the starting linenumber. For example, AUTO 3000,1 sets a 
starting line number of 3000 and an increment of 1. This code 
is also relocatable but you must patch the first instruction in 
the main AUTO command so that it uses the new code as a sub- 

routine- In this case it's :$C083 C083 D392:20 17 03 N C080. 
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The addresses specified for these new features are for the 
corrected version of the Assembler - i.e. serial nos. greater 
than 1251; see note in AAL March '85. Here is a table of what 
to expect at each of the addresses used, so you can find the 
equivalent spots in other copies of the assembler: 


$D198 -- 20 xx D2 (JSR GNC) 
BO 17 (BCS to RTS) 
49 30 (EOR #$30) 
$D392 -- 20 xx Dl (JSR GET.VALUE) 
CA (DEX) 
30 OE (BMI to SEC) 
SD40B -- 41 55 54 CF (.AT /AUTO/) 
xx D3 (.DA AUTO-1) 
SDB9A -- 09 80 (ORA #$80) 
9D 00 02 (STA $0200,X) 
C9 AO (CMP #S$A0) 


Note that with the Auto/Manual Toggle function installed you 
won't need the MANUAL command any more, so you have a spare 
command if you need it! 


}900 SSAVE S-AUTO/MAN 


1020 ~OR $300 
. -TF AUTO/MAN TOGGLE 
5A=- 1050 INCREMENT -EQ $5A,5B 
B8- 1060 SYM.VALUE - ER 8,B9 
E3- aohG AUTO.FLAG E 3 
DO028— 1090 WARM.START ~EQ $D028 
D198- 1100 GET.VALUE “Ee D198 
DAOB- 1110 AUTO.CMD E D40B 
DB9A- HE INSTALL . CHAR -EQ $DB9A 
1180 AUTO .MAN .CODE 
0300- 8A i120 TXA check cursor posn. 
0301- FO 09 1160 BEQ .1 OK to output cmd. 
0303- EO 07 Aho CPX # line start? 
030 BO OF 1180 BGE . ignore ESC-U. 
0307— 46 BR 1190 LSR AUTO.FLAG cancel auto-mode. 
0309- 4C 28 DO Tb JMP WARM.START 
030C- BD OB D4 1220 .1 LDA AUTO.CMD,X output cmd. name 
O3SOF- 20 9A DB ‘Sen JSR INSTALL. CHAR ut in buffer+scrn. 
wee ee a aa re 
> e no. 
0316—- 60 ieee 32 RTS exit ESC-U routine 
1580 *# Point start of AUTO cmd. handler 
aaaG 7 to here for extended function. 
1319 NEW. AUTO. EXT | 
0317- 20 98 D1 1320 JSR GET.VALUE get linenum if any. 
031A- 20 98 Di 1 Bo JSR GET.VALUE et inc. if any. 
ge ob ee GA peop 
- e no 
i et ne? mg ps 
0. 
O33 - A5 B8 1 KS LDA SYM.VALUE set inc. low byte 
032 5 5A 1 He STA INCREMENT 
1400 # (following 2 lines only needed 
1410 ® if you use increments of 255+!) 
1420 # DA SYM.VALUE+1 set inc. high byte 
net # STA INCREMENT+1 
0327= 60 14 1 RTS finish AUTO cmd. 
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12 Good Reasons Why 
RAMWORKS' Is The Best 
Expansion Card For Your IIe 


1 APPLEWORKS MEMORY Even though Ramworks enhances and 
expands a VAST ARRAY of other programs, Appleworks is our claim to fame. A 
GAK Ramworks will ADD 46K to vour available desktop memon, a 128K 
Ramworks will ADD 91K, a 256K Ramworks will ADD 182K. and a 512K 
Ramworks will ADD 364K and a 1 meg Ramworks will give you nearly an 800K 
desktop. And it’s all done automatically! When you plug in more memory 
chips into your Ramworks card, Appleworks will find them— automatically. 
Ramworks also increases the maximum number of records from 1350 to 4300. 


2 APPLEWORKS SPEED AND POWER Rfamworks does more than 
just increase the desktop memory (as if that weren't enough). With Ramworks, 
Appleworks will be able to run up to 20 times faster. If you buy a 256K or 
larger Ramworks card, Appleworks will automatically load itself in Ramworks. 
This greatly increases the speed at which Appleworks operates by eliminating 
al) that nasty, time consuming disk access on Drive 1. These are but a few 
feasons why we say that Ramworks is Appleworks best friend. 


3 EXPANDABILITY Ramworks was designed with the future in 
mind, as your needs increase, so can Ramworks. Clear instructions show vou 
how to plug in more memory (up to 1 meg). 


4 SPEED Today, as programs become more and more sophisticated, they 
inevitably become larger. And many of today’s best selling programs (like 
Appleworks) won't fit in a 128K Apple, so many of these new larger programs 
continually go back to disk in search of more data. With Ramworks, you can 
have enough memory so that the entire program will be loaded into 
Ramworks’ memory. This greatly increases the speed of software because your 
disk runs at 300 RPM, but Ramworks operates at the speed of light! 


5 COLOR The same slot that’s used for memory expansion is also the slot 
that's used for RGB color display, so all those lesser memory cards of 
yesterday make you decide in advance if you want RGB color. Only Ramworks 
lets you decide later to add RGB color. For only $129, an RGB option can be 
added to Ramworks to give you double high resolution color graphics and 80 
column text All with a razor sharp, vivid brilliance that's unsurpassed in the 
industry. The RGB option does not waste another valuable siot, but rather 
plugs into the back of Ramworks and attaches to any Apple compatible 
monitor. Remember, vou can order the RGB option with your Ramworks or 
add it on at a later date. 


6 COMPATIBILITY, OF THE SOFTWARE KIND Programs like 
Appleworks, Magic Office System, Flashcalc, The Spread Sheet, Diverse-A-Dos, 
Supercalc, Magicalc and many others automatically recognize all or most of 
Ramworks memory (512K is average). The simple fact is that Ramworks is 
compatible with more off-the-shelf software than any other RAM card. 
Ramworks is 100% compatible with ALL software written for the Apple 80 
column and extended 80 column card. Additionally, Ramworks can emulate 
other RAM cards so software written for other cards will run without 
modification. Software written for RAMWORKS will not work on other cards. 
We can emulate others, but others can't emulate us. 


7 COMPATIBILITY, OF THE HARDWARE KIND Unlike others. 
Ramworks is fully compatible with hardware add on’s from other companies. 
like the Sider and Profile hard disks. And Ramworks was designed in 
accordance with the official expansion rules defined by Apple so vou don't 
have to worry about compatibility problems. As vou continue to expand and 
make your Apple more powerful with other expansion products from Applied 
Engineering, you'll appreciate how each product has extra features designed 
to work with Ramworks and other products to give vou a total performance 
package that is more powerful than the sum of its part. 


8 IT SELLS THE MOST Popularity translates into great software support 
because software companies can’t support all RAM cards, they can only 
support the ones their customers are likely to Own And software companies 
appreciate the fact that when they write software for Ramworks in the He. 


theyre also writing software for our memory expansion card for the Hc, 
Z-RAM. And our customer list reads like the Who's Who of Apple computing 
with just about every software company in the land buying one, including 
Apple Computer (in the hundreds), Rupert Lissner, and Steve Wozniak (we 
didn't give one to Mr. Wozniak just to use his name, 2 one meg Ramworks 
were paid for at full price). 


9 IT’S FROM APPLIED ENGINEERING Unlike most of the 
competition, we only make accessories for Apple, so we'll never spend your 
money on IBM product research. Applied Engineering's years of experience 
and wide product line really pays off, and because of our high sales levels we 
buy most of our LC. chips factory direct. So don’t let our low prices fool you, 
they're caused by high volume production. That's why we can offer the most 
memory for the least money. Guaranteed! 


1 0 ITS GOT IT ALL 
& Sharp 80 Column Text 
Double high resolution graphics 
(with or without RGB option) 
User Expandable to 1 Megabyte 
Can Use 64K or 256K RAMS in 
any combination 
Adds Memory to Appleworks 
@ Accelerates Appleworks 
& 100% Compatibility with 

All He software 


& RAM Disk software available, 
compatible with Applesoft, 
PRO-DOS, DOS 3.3, and PASCAL 
($29) 

& RAM Disk available for CP/M 
($29). (This program is included 
with our CP/M card) 

& Visicalc preboot available ($29) 

& RGB option 

& Takes only one slot 

& 3 vear no hassle warranty 


Ql 


RQ Qe 


1 1 THE PATENT OFFICE HAS ONE There are many advanced 
features on Ramworks, but wo parts of the design are so advanced we 
applied for patents. One patent application deals with our ultra fast, ulera 
smooth 80 column screen display, and the other patent application deals with 
our ingenious way of dramatically reducing the power and heat of memory 
chips and improving reliability at the same time. 


1 2 HERE TODAY, HERE TOMORROW In the seven years we've 
been making products for the Apple, we've seen a lot of companies come and 
go. Although nothing is forever, we're growing, expanding and we're 
profiable. And we are totally committed to Apple computing, which means 
you'll never run out of things to do with Ramworks. Or for that matter, 
reasons to buy one. 


Ramworks™ with 04K $179 
Rumworks”™ with 128K . $249 
Ramworks”™ with 256K $299 
Ramworks™ with 512K... $399 
Ramworks™ with 1 MEG. . $649 
RGB Option (can be added later) $129 


Call (214) 241-6060 
9am. to 1 pm. 7 days a week or send check or money order to: 
Applied Engineering, P.O. Box 798, Carrollton, Texas “5006 


= 
C MasterCard = aailigs Visa and 
COD. welcome. No ext charge for credit cards. Texas Residents add 34a, 
sales tax. Add $10.00 if Outside U.S.A 


A 


APPLIED ENGINEERING 
“We Set the Standard” 
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Apple ProDOS: Advanced Features for Programmers, a Review..... 
eeeeeBill Morgan 


Gary Little, the prolific author of Inside the Apple //e and 
Inside the Apple //c, has yet another new book out. This one 
is called Apple ProDOS: Advanced Features for Programmers. In 
this volume Little covers just about all you need to know to 
write assembly language programs under ProDOS, from simply 
passing commands to BASIC.SYSTEM, through great detail on all 
the MLI calls, to writing your own interrupt handlers and 
device drivers. 


Here's a quick summary of the book's contents: 


1 - An Introduction to ProDOS -- Little starts out with the 
history of Apple's DOS's, a comparison of ProDOS and DOS 
3 3- and a summary of important features of ProDOS. 


2 - Files and File Management -- Here he covers the directory 
structures, file structures, disk formatting, and gives us 
a READ.BLOCK program. 


3 - Loading and Installing ProDOS -- This chapter goes into the 
boot process, ProDOS' memory usage, and the Global Page. 


4 - The Machine Language Interface -- This is the information 
on using the MLI, its error codes, and complete details of 
all MLI calls. 


5 - System Programming Featuring BASIC.SYSTEM -- Here we have a 
discussion of system programs, the structure and commands 
of BASIC.SYSTEM, and assembly language programming under 
BASIC.SYSTEM. 


6 - Interrupts -- In this chapter Little covers interrupts in 
general, ProDOS interrupt handling, and programming the 
Apple mouse. 


7 - Disk Drivers -- Nearing the end, we go into identifying and 
handling foreign disk drivers, driver commands, the /RAM 
driver, and adding your own driver 


8 - ProDOS Clock Drivers -- And finally we find out about using 
the built-in clock support. adding a clock driver, and 
reading the date and time from Applesoft. 


An important strength of this book is the wealth of examples. 
In the chapter on the Machine Language Interface there is an 
example of the correct use of EVERY MLI call. The BASIC.SYSTEM 
chapter includes an ONLINE command, to identify all disk 
volumes currently on line. The chapter on interrupts contains 
a couple of examples of mouse programming. The Disk driver 
section has a listing of a simple /RAM driver for main memory. 
And this is just a sample of the useful code provided in 
Little's new book. A companion disk containing all of the 
book's programs and more is available for $25.00 from the 
author. 
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I hear some of you asking: How does ayers ProDOS: Advanced 
Features (APAF) compare to Beneath Apple ProDOS (BAP)? Well, 
the two books complement each other quite nicely. With all its 
examples, treatment of interrupt handlers and device drivers, 
and overall clarity. I'd say that APAF is the better book on 
programming under ProDOSs BAP has useful examples as well, and 
better detail about the internals of diskette formatting and 
how ProDOS works, especially with its 120+ page supplement 
describing the code on a line-by-line basis. So if you're 
concerned with understanding the inner workings of the 
operating system, or with modifying its behavior, BAP is the 
book to have. Otherwise, get APAF for the best information on 
programming using ProDOS- Personally, I'm glad to have both 
books on the shelf here, along with Apple's ProDOS Technical 
Reference Manual. 


Apple ProDOS: Advanced Features for Programmers, by Gary B. 
Little. Brady Communications Co., 1985. 266+iv pp., Reference 
Card. $17.95. Available from S-C Software for $17 + shipping. 


Windows 


Assembly Corner 
Technical Products 


for the Apple and Macintosh Computers 
}ISOI NW lethR 
Pembroke Pines, FL 


Assembly Corner is now offering two courses an Assembiy 
language for Une Apple Il series of computers. 


}). Assembiy for Lhe serious beginner - 
a one year course on twelve manthiy disks, each one 


practical techniques that you can USE. 


2 Gaphics and Animation Series - : 
A four month course on four disks, filled with information: 
on Apple graphics techniques, ROM routines, HPLOT 

animation, raster shapes, pre-shifted shapes and more. 4 
includes special programmer's utility nol available : 
ebewhere. This course requires an intermediate 

; understanding of Assembiy Language. 

f A FREE ASSEMBLY CORNER POSTER WITH EACH ORDER! 

Both courses require an Apple II (any kind), a printer, and 4 

one disk drive. A color monitor or TV ts recommended for 

Une Graphics Series For more details call (30S) 431-6602 ; 


for the Apple {| computer 


® Windows ts a mechine language utility program for Basic pro- 
momers. It edds ten new commends to Applesolit Besic, 

* which aliow you lo create windows in the Appie Lezt screesa. 

> Dtspley eny message. meau, cic. right over the existing text. 

S without destroying the original d y. Text inside wiadows 

® scroiis independentiy. in itice, Windows aliows you to spilt 
S the screen vertically and horizontally, and use eech helf sepe- =} 
rately, end you can create other special effects tool 

& The possibilities are endiess. 1{ you program ia Basic, you'll 
= love doing Windows! 


| Mee want to do Vindows oa my Appie!l Here’s my check for | 


{0 One month trial - Beg ers’ series Sone 00. ee 


Bee B Assembly Corner 
mnmn-en- HIGOO i iiiiis: ©. 11601 0.V 1Gth RR. 
5 Pembrote Pines, FL 33026 
(305) 431-6692 
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If You Have 


APPLEWORKS” 


It’s Easy To Tell If You 
Have A Timemaster H.O. Clock 
In Your Apple 


TPE Tumbe hen press 


Just Look Right Here 


Only the Timemaster HLO. displays the date and time on, 


the Appleworks screen.* If vou don’t have a Timemaster 
HLO., youll just get the help kev reminder. The 
Timemaster HO. will also automatically me and date 
stamp your files on disk. And domt forget. the Timemaster 
ILO. has all the features of all the competition combined, 
including vear, leap vear (not just in PRO-DOS), month, 
date, day, hours, minutes, seconds and milliseconds. The 
Timemaster FLO. is compatible with PRO-DOS, DOS 3.3. 
PASCAL and CP/M. And the Timemaster FLO. automatically 
emulates all other clock cards so vou worrt have any 
compatibility problems because the Timemaster FLO. 
works with ANY program that reads ANY clock. 

In fact, vou could put ALL the competitive cards in every 
slotin vour Apple and vou still wouldn't have all the 
features of the Timemaster HO. 

The Timemaster FLO. comes with a ton of fun and 
useful software. Ht has an easy to read vet detailed manual, 
a 20 year auto-recharging battery and a 3 year no hassle 
Warranty. 


TIMEMASTER H.O. 
SIMPLY PUT, 
IT’S SIMPLY THE BEST $129.00 Complete 


"if you purchased a Timemaster FLO. prior to AppleWorks support, an easy 
t© Use patch program is available for $20.00. 


APPLIED ENGINEERING 
We Set the Standard 


Call (214) 241-6060 9 a.m. to 1! p.m. 7 days a week or 
Send check or money order 

P.O. Box 798 

Carrollton, Texas 75006 


eo = 


MasterCard, Visa and C.O.D. welcome. No extra charge 
for credit cards. 

Texas residents add 5%% sales tax. 

Add $10.00 if outside U.S.A 
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Adapting the Output Format of Rak-Ware DISASM.......Bob Kovacs 


This technical note describes the format table used within 
DISASM 2.2e. which can be modified to adapt the output text 
file format to other assemblers. Even if you never plan to 
modify DISASM, or even if you don't own a copy of DISASM, you 
can learn a lot about the use of configuration tables by 
studying what follows. 


The current version of the disassembler provides three 
different output formats to support the DOS ToolKit, S-C, and 
LISA assemblers. The format table contains various attributes 
which are unique to each assembler- The table begins at 
location $1331 and is $3F bytes long. Let's first examine the 
table and then determine how to adapt it to other assembler 
formats. 


Item ToolKit S-C LISA 
comment AA * AA * BB ; 
firstchr 00 none 89 “I 00 none 
tabchrl AO spc 89 “I AO spc 
tabchr2 AO spc Ad spc Ad spc 
opchr Cl A 00 none 00 none 
pgzchr C5D1D5 EQU AEC5D1 .EQ C5DODA EPZ 
extchr C5D1D5 EQU AEC5D1 .EQ CS5D1D5 EQU 
hexchr C4C6C2 DFB AEC8D3 .HS C8C5D8 HEX 
orgchr CFD2C7 ORG AECFD2 .OR CFD2C7 ORG 
prechr AAOO0O0O * 000000 none C9CED3 INS 
postchr 00 none 98 “xX 85 “E 


comment: the character used at the beginning of a line 
to signify a comment line. 


firstchr: the character ouput at. the beginning of each 
line. 


tabchrl: the character used to tab to the opcode field. 
tabchr2: the character used to tab to the operand fiela. 


opchr: operand for impled accumulator instructions 
(ASL, LSR, ROR, ROL). 


pgzchr: directive for page zero declarations. 
extchr: directive for absolute declarations. 
hexchr: directive for data tables. 

orgchr: directive for setting the program origin. 


prechr: preamble sequence for initialization of the 
assembler 


postchr: postamble character for termination of the 
assembler's loading operation. 
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You will find that it is relatively simple to modify the format 


table for other 


assemblers. 


First, determine which of the 


three existing formats is to be overwritten (just pick the one 


you think you'll need the least). 
data which is appropriate to your assembler 
enter the monitor. and stuff the new values into the table. 


Finally BSAVE DISASM,A$800,LSD00. 


Then determine the format 
BLOAD DISASM, 


Or. if you have purchased the source code of DISASM 2.2e (or 
Created your own using DISASM!), you can merely edit the table 
with your assembler and re-assemble the program. 


You might also need or want to change some other parameters, 
which are not in the format table: 


Label Prefix: 


C9DAD8 (the letters “IZX"). 
indicate internal, pagezero, and external labels in the 
generated text file. 


Menu Table; 


Label Name Separator: 
second character in every generated label name. 


located at $132E, the current value is 


These letters are used to 


located at $1300, this table contains the 

names of the three assemblers listed in the first menu. 
Each name is stored in ASCII, followed by a return (SOD) 
and a terminator ($00). 


A period (SAE) is output as the 


This can 


be changed to any other character by editing the LDA #SAE 
instruction at location SOEA4. 


I would be interested in hearing from any of you who have 


already modified DISASM. 


This kind of feedback can lead to new 


versions with even more powerful features. 


Now you can monitor and control the world (or at least your part of it) with a little help from 


APPLIED ENGINEERING 


12 BIT, 16 CHANNEL, 
PROGRAMMABLE GAIN A/D 
@ All new 1984 design incorporates the 
latest in state-of-art 1.C. technologies. 
@ Complete 12 bit A/D converter, with an 
accuracy of 0.02%! , 


@ 16 single ended channels (single ended 
means that your signals are measured 
against the Apple’s GND.) or 8 
differential channels. Most all the 
signals you will measure are single 
ended. 

9 software programmable full scale 
ranges, any of the 16 channels can have 
any range at any time. Under program 
control, you can select any of the 
following ranges: +10 volts, +5V, 
+2.5V, £1.0V, £500MV, +250MV, 
+100MV, +SOMV, or £25MV. 

Very fast conversion (25 micro seconds). 
Analog input resistance greater than 
1,000,000 ohms. 

Laser-trimmed scaling resistors. 

Low power consumption through the 
use of CMOS devices. 

The user connector has +12 and -12 
volts on it so you can power your 
sensors. 

Only elementary programming is 
required to use the A/D. 

The entire system is on one standard 
size plug in card that fits neatly inside 
the Apple. 

@ System includes sample programs on 


take PRICE $319 
A few gry may include the mon- 
toring of @ flow @ temperature @ humidi- 
ty @ wind specd © wind direction @ light 
intensity @ pressure @ RPM @ soil mois- 
ture and many more. 


A/D & D/A 
A/D & D/A Features: 
@ Single PC card 
@ 8 channels A/D 
@ 8 channels D/A 
@ Superfast conversion time 


@ Very easy programming 
@ Many analog ranges 
@ Manual contains sample applications 


A/D SPECIFICATIONS 

@ 0.3% accuracy 

@ On-board memory 

@ Fast conversion (.078 MS per channel) 

@ A/D process totally transparent to 
Apple (looks like memory) 

@ User programmable input ranges are 
0 to 10 volts, 0 to 5, - 5 to +5, - 2.5 
to +2.5. -5to0, -10 to 0. 


The A/D process takes place on a continuous, 


channel sequencing basis. Data is automatic- 
ally transferred to its proper location in the 
on-board RAM. No A/D converter could be 
easier to use. 
D/A SPECIFICATIONS 

@ 0.3% accuracy 
@ On-board memory 
@ On-board output buffer amps can 

drive 5 MA 
@ D/A process is totally transparent to 

the Apple (just poke the data) 
@ Fast conversion (.003 MS per channel) 
@ User programmable output ranges are 

0 to 5 volts and 0 to 10 volts 
The D/A section contains 8 digital to analog 
converters, with output buffer amplifiers and 
all interface logic on a single card. On-card 
latches are provided for cach of the eight 
D/A converters. No D/A converter could be 
easier to use. The on-board amplifiers are 
laser-trinomed during manufacture, thereby 
climinatiny any requirement for off-set 


nulling. PRICE $199 


SIGNAL CONDITIONER 


Our 8 channel signal conditioner is designed for use with both our A/D converters. This 
board incorporates 8 F.E.T. op-amps, which allow almost any gain or offset. For example, 
an input signal that varies from 2.00 to 2.15 volts or a signal that varies from 0 to 50 
mV can easily be converted to 0-10V output for the A/D. 


The signal conditioners outputs are on a high quality 16 pin gold 1.C. socket that 


matches the one on the A/D’s so a simple ribbon cable connects the two. The signal 
conditioner can be powered by your Apple or from an external supply. 


FEATURES ‘ 

@ 4.5” square for standard card cage and 4 mounting holes for standard mounting. The 
Aa aaa does not plug into the Apple, it can be located up to % mile away from 
t D. 


@ 22 pin.156 spacing edge card input connector (extra connectors are easily available ie. 
Radio Shack). ? 


@ Large bread board area. 
@ Full detailed schematic included. 


tk 


@ Provides 4, &-Bit programmable 1/O 
Ports 


PRICE $79 


1/O 32 


@ Your inputs can be anything from 
high speed logic to simple switches 


@ Programming is made very easy by 
pow erful on-board firmware 


@ The 1/O 32 is your best choice for any 


@ Any of the 4 ports can be pro- is YO 
control application 


grammed as an input or an output 
port 


@ All 1/0 lines are TTL (0-5 volt) 
compatible 


The 1/O manual includes many programs 
for inputs and outputs. 


Some applications include: 
Burglar alarm, direction sensing, use with relays to tum on lights, sound buzzers, start 
motors, control tape recorders and printess, use with digital joystick. 

PRICE $89 


Please see our other full page ad in this magazine for information on Applied Engineering's Timemaster Clock Card and other products for the Apple. 
Our boards are far superior to most of the consumer electronics made today. All |.C.’s are in high quality sockets with mil-spec. components used throughout P.C. boards are glass-epoxy 
with gold contacts. Made in America to be the best in the world. All products compatible with Apple II and //e. 


Applied Engineering's products are fully tested with complete documentation and available for immediate delivery. All products are guaranteed with a no hassle three year warranty. 


Texas Residents Add 5% Sales Tax 


Add $10.00 If Outside U.S.A 


Send Check or Money Order to: 
APPLIED ENGINEERING 


Call (214) 492-2027 
7 am. to 11 p.m. 7 days a week 
MasterCard, Visa & C.0.D. Welcome 
No extra charge for credit cards 
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DATE Command for PLODOS <4 64: 4.000000 4 660445466440%4i080Bi1)] Morgan 


One of the nice new features in ProDOS is the way the diskette 
catalog shows the date of creation and last modification for 
each file, IF you have a clock/calendar card installed in your 
Apple- Well I don't have such a card in either of the Apples I 
use regularly, at work or at home. And no //c has a clock! 
(Yet, at least. I'll bet someone will come up with a way...) 


Anyway, I got tired of always seeing <NO DATE> and started 
figuring out how to set a date without a clock to do it for me. 
A look at Beneath Apple ProDOS informed me that the current 
date is transformed into the format YYYYYYYMMMMDDDDD and stored 
(in the usual 6502 low byte/high byte sequence) at SBF90-BF91 
in the ProDOS Global Pages (the fixed locations of all of the 
accessible system variables). The first thing I did was 
Manually convert the current date into that format and poke it 
in from the Monitor. That went like this: 


SBF90 SBF91 
May = $5 = 0101 MMM DDDDD YYYYYYY M 
10 = SA = 01010 .101 01010 1010101 0 
‘85 = $55 = 1010101 SAA SAA 


So, the values to poke into $BF90-9l1 were SAA and SAA. What 
better time than a four-A day to start such a project! 


That experiment worked just fine: the next file I saved on the 
disk showed creation and modification dates of 10-MAY-85, just 
as I had hoped. With that success under my belt the next step 
had to be to come up with a program to read and/or set those 
date bytes. And, while I'm at it, why not take advantage of 
ProDOS' built-in hooks for installing new commands and add a 
DATE command to the operating system? 


How do I go about adding a command? The ProDOS Technical 
Reference Manual is pretty sketchy on the subject, but two 
other books, Beneath Apple ProDOS and the new Apple ProDoS: 
Advanced Features for Programmers, have good descriptions and 
examples of the procedure. If you're going to do much assembly 
language programming under ProDOS you should have one or both 
of those books. 


When ProDOS fails to recognize a command it does a JSR EXTRNCMD 
($BE06) to find out if an external command processor will claim 
this one. What I have to do is install the address of DATE in 
SBEO7-08, after moving the address that was already there into 
a JMP instruction. This way, if DATE doesn't recognize the 
command it can pass it along to any other processor that might 
have been there before. 


Processing of an external command is normally divided into two 
phases, a parser and a handler- The parser section will scan 

the command name at the beginning of the line. If the command 
is not recognized, the parser should set the carry bit and JMP 
on to the address found in EXTRNCMD to see if another external 


processor will claim it. 
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If the command is recognized, the parser can set certain bits 
in PBITS (S$BE54-55) to signify which parameters are permitted 
Or required on the command line. and store the address of the 
handler in EXTRNADDR ($BE50-51). After storing the command 
length minus one in XLEN ($BE52) and a zero in XCNUM (S$BE53), 
to signify that an external processor did claim the command, 
the parser then returns control to ProDOS to scan the rest of 
the line. If the line was syntactically correct, ProDOS will 
return the values of the parameters in a set of standard 
locations (S$BE58-6F) and pass control back to the handler 
address specified. 


Since DATE is a simple processor that uses a nonstandard 
parameter, I just set PBITS to zero, to indicate no parsing 
necessary, and store the address of an RTS instruction in 
EXTRNADDR. I then proceed to do all my processing before 
returning to ProDOS 


There is one additional wrinkle to using an external command 
with ProDOS: where do I put my code so ProDOS, Applesoft, and 
others don't stomp all over it? In the interest of simplicity 
I have ignored that problem here. The best procedure, as shown 
in the books mentioned above, is to call ProDOS to assign me a 
buffer and then relocate my code into that buffer- The 
examples in the books provide details of this process. 


Now, let's take a look at the code: 


Lines 1310-1400 install DATE by moving the current External 
Command address to my exit JMP instruction and storing DATE's 
address in the vector. 


Lines 1440-1540 check the input buffer to see if this is a DATE 
command, If not we branch on down to that JMP instruction 
where we earlier put the address found in the External Command 
vector. This passes control either on to the next external 
command in the chain, or back to ProDOS for a SYNTAX ERROR. 


If the command matched we go on to lines 1560-1650 to do the 
necessary housekeeping. This involves storing the command 
length-1 in the Global Page, setting a couple of flags to tell 
ProDOS not to parse the rest of the command line. and that an 
external command has taken over. Then we supply a handler 
address for the second half of ProDOS' processing, which in 
this case is just an RTS instruction. Finally we reach lines 
1670-1690. where we check to see if the character following 
DATE is a Carriage Return. If so we branch forward to 
RETURN.DATE to display the existing date. 


If there is more than just DATE on the command line. we must 
want to set a new date, so we fall into SET.DATE at line 1710. 
This routine makes heavy use of ACCUMULATE.DIGITS at line 2400, 
so we'll examine that code first. The first step is to zero 
the byte where we'll be accumulating the value typed in. Then 
we scan forward in the input buffer, looking for a nonblank 
character. When we find one we first check to see if it is a 
slash. which marks the end of a number, or a Carriage Return, 
which marks the end of the line. If it was either of those we 
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SCESECESEEEEEEEEEEEEEEEESEEEEESEESEEEEEEEEES 


FONT DOWNLOADER & EDITOR ($39.00) 

Turn your printer into a custom typesetter. Downloaded characters remain active while printer is powered. 
Use with any Word Processor program capable of sending ESC and control codes to printer. Switch back and 
forth easily between standard and custom fonts. All special printer functions (like expanded, compressed etc.) 
apply to custom fonts. Full HIRES screen editor lets you create your own characters and special graphics 
symbols. Compatible with many parsilel printer |/F cards. User driver option provided. For Apple II, ll+, //e. 
Specify printer: Apple Dot Matrix, C.ltoh 8510A (Prowriter), Epson FX 80/100, or OkiData 92/93. 


NEW ! !! The Font Downloader & Editor for the Apple Imagewriter Printer. for use with 
Apple Il, il+, //e (with SuperSerial card) and the new Apple //c (with builtin serial interfece). 


NEW !!! FONT LIBRARY DISKETTE #1 ($19.00) contains lots of user-contributed fonts for all 
printers supported by the Font Downloader & Editor. Specify printer with order. 


DISASM 2.2e - AN INTELLIGENT DISASSEMBLER ($30.00) 

Investigate the inner workings of machine language programs. DISASM converts machine code into meaningful, 
symbolic source. Creates a standard text file compatible with S-C, LISA, ToolKit and other assemblers. Handles 
data tables, displaced object code & even lets you substitute your own meaningful labels. (100 commonly used 
Monitor and Pg Zero names included.) An address-based triple cross reference table is provided to screen or 
printer. DISASM is an invaluable machine language learning aid to both novice & expert alike. Don Lancaster 
says DISASM is “absolutely essential” in his new ASSEMBLY COOKBOOK. For entire Apple I! family including the 
new Apple //c (with all the new opcodes). SOURCE CODE available for an additional $30.00 


S-C Assembler (Ver 4.0 only) SUPPORT UTILITY PACKAGE ($30.00) 

* SC .XREF - Generates a GLOBAL LABEL Cross Reference Table for complete documentation of source listings. 
* SC.GSR - Global Search & Replace eliminates teadious manual renaming of labels. Search all/part of source. 
* SC.TAB - Tabulates source files into neat, readable form. SOURCE CODE available for an additional $30.00 


The ‘PERFORMER’ CARD ($39.00) 

Plugs into any slot to convert a ‘dumb’ centronics-type printer I/F card into a ‘smart’ one. Command menu 
eliminates need to remember complicated ESC codes. Features include perforation skip, suto page numbering 
with date & title. Includes Jarge HIRES graphics & text screen dumps. Specify printer: MX-80 with 
Graftrax-60, MX-100, MX-80/100 with Graftraxplus, NEC 6092A, C.Jtoh 6510 (Prowriter), OkiData S2A/83A 
with Okigraph & OkiData 92/93. SOURCE CODE: $30.00 


FIRMWARE FOR APPLE-CAT: The ‘MIRROR’ ROM ($25.00) 

Communications ROM plugs directly into Novation's Apple-Cat Modem card. Basic modes: Dumb Terminal, 
Remote Console & Programmable Modem. Features include: selectable pulse or tone dialing, true dialtone 
detection, audible ring detect, ring-back, printer buffer, 80 col card & shift key mod support. Uses superset of 
Apple's Comm card and Micromodem || commands. SOURCE CODE: $50.00 


RAM/ROM DEVELOPMENT BOARD ($30.00) 
Plugs into any Apple slot. Holds one user-supplied 2Kx8 memory chip (6116 type RAM for program development 
or 2716 EPROM to keep your favorite routines on-line). Maps into $CnO0-CnFF and $C800-CFFF. 


NEW !!! C-PRINT For The APPLE //c ($99.00) 

Connect standard parallel printers to an Apple //c. C-PRINT is a hardware accessary that plugs into the 
standard Apple //c printer serial port. The other end plugs into any printer having a standard 36 pin 
centronics-type parallel connector. Just plug in and print! High speed data transfer at 9600 Baud. No need to 
reconfigure serial port or load software drivers for text printing. 


Avoid a $3.00 postage/handling charge by enclosing full payment with order. (Mastercard & VISA excluded) 
RAK-WARE 41 Ralph Road W. Orange NJ 07052 (201) 325-1885 


CESCEECEEEEEEEEEEEEEEEEEEEEEEEEEEEEEESE 
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exit, setting the Carry bit to indicate which one we found. 


If the character found was not a delimiter we next check to see 
if it is a number. If not, we have a SYNTAX ERROR. When we do 
get a number. we strip off the high bits to convert the ASCII 
code to a binary value, and save that value. We then multiply 
the previous value in ACCUM by 10 and add in the new value. 
Then it's back to line 2440 to get another character. Lines 
2710-2730 load the A-register with the value found and branch 
to the error exit if that value was zero. 


Now, back to SET.DATE. That routine begins at line 1720 with a 
DEY to get ready for the INY at the beginning of 
ACCUMULATE.DIGITS. We then get the month, check for a legal 
value, and store it. Next we get the day, save the status, and 
check and save that value. Then it's time to check the status 
to see if the day was followed by a slash, or by a Carriage 
Return. If it was a slash then a year was specified, so we go 
get that value. If it was a Return no year was present, SO we 
use 1985. (I guess that means we'll have to reassemble or 
patch this program every year. I think I can handle that.) 


The last step in SET.DATE is to fold the year, month. and day 
together as described above and store the results in the Global 
Page. The comments in the listing illustrate how the bits are 
shuffled around to the correct format. After setting the date 
we fall into RETURN.DATE to display the result. 


RETURN.DATE, at lines 2080-2290, is quite straightforward. It 
just gets the bytes from the Global Page, unfolds them, and 
calls DEC.OUT to translate them to decimal numbers and display 
those numbers. Again, the comments illustrate the bit 
manipulations involved in the unfolding process. 


The final section of code is DEC.OUT, at lines 2750-2910. In 
lines 2760-2810 we use the Y-register to count how many times 
we can subtract 10 from the number passed in the A-register. 
Then lines 2830-2910 restore and save the A-register, make sure 
the tens count is non-zero, convert it to a character and print 
it. We then recover the units value and print that out. 


1000 *SAVE S.DATE 
1010: Becemecccc cc cecncbncecawcecncosus 
1020 @ 
sake # Program to read or set the date 
i ; bytes in the ProDOS Global Page 
1080 # by Bill Morgan 
ie # 
1080 #2 nnn ee enw wn enw 
40- 1090 POINTER -EQ $40,41 
4y2- 1100 ACCUM -EQ $42 
43- 1110 MONTH EQ $4 
Ke 1120 DAY ~EQ $4 
45— aie TEMP ~EQ $45 
0200- ree WBUF ~EQ $200 
BEOT- te EXTRNCMD .EQ peu, 
BE50~ 1180 EXTRNADDR .EQ $BE50,51 
BE52= 1190 XLEN ~EQ $BE52 
BE53- 1200 XCNUM ~EQ $BE5 
BE54- 1210 PBITS ~EQ $BE5 
BF90- 1220 GP.DATE -EQ $BF90 
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Expanding Your IIc 
Is Easy 


With Z-RAM 


Applied Engineering and Apple computer have teamed 
up to take your IIc to new heights. 


Applied Engineering’s Z-RAM card for the IIc is available’ 
with 256K or 512K of additional memory and a powerful 
Z-80 microprocessor for running CP/M software. 


Z-RAM fits neatly inside the IIc. Installation is easy, clear 
instructions show you how. You'll need a screwdriver and 
about 10 minutes (if you can change a light bulb you can 
install Z-RAM). 


Z-RAM and Appleworks will knock your socks off. 


A 256K Z-RAM will give you a 
229K available desktop and 
Appleworks will be completely 
loaded into memory. Appleworks 
will now run about 10 times faster 
in your IIc with 1 disk drive 

than in other Ilc’s with 2 disk 
drives. A 512K Z-RAM will give 
you a 413K available desktop. 

A 256K Z-RAM can be upgraded 
to 512K by just plugging in 
more memory chips. 


Z-RAM is also a high speed solid state disk drive. With 
Z-RAM, your programs will load and save over 20 times 
faster. Z-RAM’s RAM disk is compatible with Applesoft, Pro- 
DOS, DOS 3.3, PASCAL and CP/M. And with Z-RAM, you 
can copy a disk in one pass. Just insert the original, 
remove the original, insert blank disk! That's it! Z-RAM is 
another disk drive, only 20 times faster, 4 times larger 
capacity, and no whirring, clicking or waiting! 


But before you start panting over all that extra memory, 
don’t forget that the Z-RAM card has a built-in high speed 
Z-80 processor chip that allows you to run CP/M programs 
like Wordstar, dBASE II, Turbo PASCAL, Microsoft BASIC, 
FORTRAN and COBOL and over 3,000 other CP/M 
programs. So Z-RAM not only makes Apple programs run 
better and faster, it lets you run MORE programs. 


With the Z-RAM card installed, your IIc is still your IIc 
only now you'll have that extra memory that Appleworks 


w 


and other programs need. And you can run all that great 
CP/M software that others can only dream about 


Z-RAM is 100% compatible with all IIc software and 
hardware including the mouse, 2nd disk, modem and 
printer. Z-RAM is easily handled by the IIc power supply as 
power consumption is kept very low by using two custom 
integrated circuits and a patent pending power saving 
design. And Z-RAM is from Applied Engineering, the 
acknowledged leader and innovator of accessories for the 


Apple. 


Z-RAM comes complete with manual, RAM disk software, 
Z-80 operating system, CP/M manual and a 3 year no 
hassle warranty. 


So the next time somebody asks you why you didn’t get 
an IBM P.C,, tell him you bought a IIc because the IBM 
didn’t have enough memory and was too slow and 
couldn't run CP/M software. And tell him you made it past 
the 8th grade. 


Z-RAM with 256K 
Z-RAM with 512K 


$449 
$549 


If you want to run CP/M software, but don’t need more 
memory, may we suggest our Z-80c card The Z-80c offers 
the same CP/M performance as Z-RAM but has no memory 
expansion ports. And the Z-80c will not affect the running 
of Apple programs. The Z-80c is priced at only $159.00 and 
should you ever want to upgrade to Z-RAM, we'll refund 
your full purchase price. 


Call (214) 241-6060 
9 a.m. to 11 p.m. 7 days a week or 


Send check or money order to: 
Applied Engineering 

P. O. Box 798 

Carrollton, Texas 75006 


Su. = 
MasterCard gqumms Visa and 


C.O.D. welcome. No extra charge for credit cards. 
Texas residents add 5%% sales tax. Add $10.00 if 
outside U.S.A 


Ia 


APPLIED ENGINEERING 
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“We Set the Standard”’ 


Page 28.... 


IF YOU HAVE A 
HARDWARE DESIGN FOR 
THE APPLE, APPLIED 
ENGINEERING a Bl 


DESIGNS. 


Please call or 
write 

Applied Engineering 
P.O. Box 798 
Carrollton, TX 75006 
(214) 241-6060 


.Apple Assembly Line......May, 1985......Copyright (C) S-C SOFTWARE 


FQ41- 1240 PRAX ~EQ $F941 
FD8E=-} 1250 CROUT “ES FD8E 
FDED- ‘3 : COUT -E FDED 
i380 -OR $803 
1290 # IF B.DATE 
1 & 2 ae E> ie a Gp ae Ge ee ie oe a oe i oe Oe dee ee G0 Oe es Gee a SP ee Gs Es a> 
1310 INSTALL 
hn AD 08 BE 1320 LDA EXTRNCMD+1 exit to old 
0806- 8D BA 08 1330 STA EXIT+2 user command 
0809- O07 1340 LDA EXTRNCMD 
0O80C- 8D B9 08 1350 STA EXIT+1 
O80F- AQ 0 1360 LDA /DATE become new 
0811- 8D 08 BE 1328 STA EXTRNCMD+1 user command 
O81H—- Aad 1 LDA #DATE 
0816— 8D 07 BE 1330 STA EXTRNCMD 
0819- 60 1400 RTS 
seapakk hie 910 Sieewesec ccceeneecceccekncecesces 
081D= 45 Mase COMMAND ~AS /DATE/ 
O81E- AO 00 ako DATE LDY #0 
- poin nput buffer 
GBos- ag Oe «14 TDA /WBUF ane wa enbee Were 
O824— 85 41 ne STA POINTER+1 
082 - Bi 40 1480 .1 LDA (POT NTER ) Y scan command 
0828- 29 1490 AND #$01111119 
082A- DO 1A 08 1500 CMP COMMAND, Y 
O82D- DO 1510 BNE ERR.BRIDGE not mine 
O82F- C8 1520 INY 
OB32- $0 F21eho Bee 4 
ie 1550 ®=--= ProDOS bookkeeping --------~ 
0834- 88 1560 DE 
0835- 8C 52 BE ey STY XLEN command length - 1 
OB 3. 8 00 —«t2o8 LDA #0 
D 54 BE ieee STA PBITS don't parse parns 
- 8D 33 161 STA XCNUM external command 
1i- AJ B 6 LDA # 


A #RTS1 
STA EXTRNADDR no execution after 
LDA /RTS1 command parsing 
STA EXTRNADDR+1 


COSCCCOCOCG0O 


162 

1 

ie 

1660 #--—- set or display date? ~-em<--- 
O84B=- Bi 40 167 LDA (POINTER) ,Y 
O84D=- C9 8D 16 CMP #3 DATE only? 
O84F- FO 3A ; 3 BEQ RETURN .DATE yes, return old date 

v4 SET.DATE 
0851—- 88 \7e0 DEY 
bee. a9 an 08 ; R° ip 7 aaa aad get month 
0857- BO 5E 1450 BCS ERROR >12 no good 
Ob Re 85 4 1780 STA MONTH 
0 - 20 BB 08 1 fo JSR ACCUMULATE.DIGITS get day 
ORE ob 20 «1490 CMP #32 eee 
0861- 90 03 : oe BCC £3 ON <=31 ok 
0563- 28 1820 PL? 

1830 ERR.BRIDGE 
0864—- DO 51 1830 BNE ERROR -- always 
0866—- 85 44 1860 GO.ON STA DAY 
0868- 28 1870 PLP recover status 

z 8 BCC cc. if */* 
Ae i tf i Bye 2p year aereutte to '85 
. 08 1 JSR ACCUMULATE.DIGITS get year 

ot C9 64 1336 CMP #100 
0874—- BO 41 1930 BCS ERROR >99 no good 
0876= 48 19 -2 PHA save he 
1 a 7 ae lB 
OB7A- 6A 1970 ROR M MOOOOOMM 
087B- 6A 1930 ROR M MM0000(M 
O87C=- 6A 1990 ROR M MMMO0000 
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O8 F- - é8 43 2000 STA MONTH 
: 2010 PLA M OYYYYYYY 
2020 ROL O YYYYYYYM 
ti an 1 BF 2030 STA GP.DATE+1 
OB ea iG nf 2040 LDA MONTH MMMO0000 
0 - eee 2050 ORA DAY MMMDDDDD 
0888 8D 90 BF etee . STA GP.DATE 
oon RETURN .DATE 
O88B- 20 8E FD 2090 JSR CROUT 
O88E- AD 91 BF 2100 LDA GP.DATE+1 X YYYYYYYM 
0891— 4A 2110 LSR M OYYYYYYY 
OR aS 48 2120 PHA 
0 ~- AD 90 BF 2130 LDA GP.DATE M MMMDDDDD 
0896—- 48 2140 PHA 
0897— 6A 2150 ROR X MMMMDDDD 
0 HA 2160 LSR xX 
0899—- 4A 2170 LSR X OOMMMMDD 
O89A—- 4A 2180 LSR X OOQMMMMD 
O89B— 4A 2190 LSR X O0OOQMMMM 
089C=- 20 Fi 08 2200 JSR DEC.OUT display month 
OS9F~ AQ AF 2210 LDA #*/* / 
O8Ai= 20 ED FD 2220 JSR COUT 
O8A4= 68 Sia PLA X MMMDDDDD 
O8A5— 29 IF 22 AND g5000 13115 X OOODDDDD 
O8a7T=- 20 F1 08 2250 JSR DEC. OUT display day 
O8AA- AQ AF 2260 LDA #*/* / 
O8AC- 20 ED FD eohe JSR COUT 
O8aF- 68 2280 PLA X OYYYYYYY 
O8B0- 20 F1 08 e290 ; JSR DEC.OUT display year 
2310 GOOD.EXIT 
08B3- 48 232 signal no error 
O8B4- 60 S3ho RTS 1 RTS 
O8B5- 68 2350 ERROR1 PLA clean up 
O08B6-—- 68 2360 PLA return addresses 
OSB7-= 3 2370 ERROR SEC signal error 
O8B8- AC B4 08 greg & EXIT JMP RTS1 INSTALL makes address 
SRGO A ACCUMULATE.DIGITS 
O8BB- AQ 00 241 
O8BD=- 85 ho oa STA ACCUM zero accumulator 
O8BF- C8 24uO .1 INY next character 
O8CO- Bi 40 2450 LDA (POINTER) ,Y 
08C2= 29 7F 2460 AND #401111111 hi-bit off 
bace- FO FY Sub BEQ “1 peek ¢ 
- P ack for another 
onc - C9 2 2490 CMP #'/'* slash? 
O8CA- FO 1F 2500 BEQ .2 yes, exit .CC. 
O8CC- C9 OD 2510 CMP #$0D <cr3? 
O8CE- FO 1C 2520 BEQ . es, exit .CS. 
O8D0= C9 30 echo CMP #'0O! oo small? 
O8D2= 90 E1 25 BCC ERROR1 not digit 
O8D4- C9 3A 2550 CMP #'9'+1 too big? 
O8D6=- BO DD 2200 BCS ERROR! not digit 
O8DB8=- 29 OF 2580 AND #%00001111 isolate value 
OBDA~ 85 45 2590 STA TEMP stash it 
O8DC=- A5 42 2600 LDA ACCUM 
O8DE=- OA 2610 ASL X 2 
O8DF- OA 2620 ASL X 4 
OBEO= 65 42 26 30 ADC ACCUM X 5 
O8E2- OA 26 0 ASL X 10 
O8E3- 65 45 2650 ADC TEMP add new digit 
O8E5—- BO CE 2660 BCS ERROR1 too big 
O8E7T=- 85 42 2670 STA ACCUM 
O8E9- 90 D4 g 80 BCC .1 eee always 
O8EB- 18 2700 .2 CLC CC. if / 
a ne 
S no go 
O8F0=- 60 2 ; RTS . 
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RAMWORKS” 


MULTIFUNCTION 80 COLUMN + MEMORY CARD 


100% Apple Extended 80 Column Card compatable. Guaranteed 3 years 
and memory expandable any time up to 1024k RAM! 


RAMDRIVE software option ($26) for up to 3900 DOS 3.3 sectors and 1700 
ProDOS blocks in high speed RAM! 


UP TO 50% OFF! OUR PRICE 


Ramworks Card (Complete)* 
Ramworks Card (Complete)* 
Ramworks Card (Complete)* 
Ramworks Card (Complete)* 
Ramworks Card (Complete)* 
Timemaster HO Timecard 
Z-Ram Card for //c* 

Z-Ram Card for //c* 
AppleWorks Program 


* FREE AppleWorks Expander software included! 


MORE MEMORY 


Let our RAM chips expand your Ramworks card up to 1024k! We can 
expand your Titan, Microfazer, Microbuffer, Buffered Grappler, and other 
cards also. FAST (150 NS), economical chips. GUARANTEED 1 year. 


UP TO 60% OFF! LIST OUR PRICE 
64k Memory Expander Kit 70 35 
128k Memory Expander Kit 140 62 
256k Memory Expander Kit 250 124 
512k Memory Expander Kit 500 227 
1024k Memory Expander Chips 1000 424 
Piggyback Board (Req. for 1024k Kit) 129 124 


Terms: For fastest delivery send Cashier's or Certified check or Money Order. C.0.D. and 
personal checks accepted (allow 14 days to clear). Add 3% for Master Card/Visa (include 
# and expiration). Add $3 shipping. Texas residents add 6%% sales tax. 


Ramworks/Ramdrive/Z-Ram/Timemaster HO, BPI General Accounting, Sensible Spelier, Microfazer, 
Microbuffer, Buffered Grappler, AppleWorks/ProDOS respective trademarks of Applied Engineering, BPI 
Systems, Sensible Software, Quadram Corp., Practical Peripherals, Orange Micro, Apple Computer. 256k 
chips work with Ramworks/Z-Ram cards only. Dealer inquiries welcome. 


COIT VALLEY COMPUTERS (214) 234-5047 
14055 Waterfall Way Dallas, Texas 75240 
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2750 DEC.OUT 


O8F1=- AQ 00 2760 LDY #0 zero counter 

ORE - ag 2 fe SEC get ready 

O8F4= EQ OA 2780 .1 SBC #10 subtract 10 
O8F6- 90 03 2790 BCC .2 borrow? 

O8F8- 8 2800 INY count a 10 

O8FB- 69 OA 2830 .2 ADC #10 restore borrow 
O8FD=- 4 2840 PHA save units 

O8FE- 9 2850 TYA print 10's count 
8FF- FO 05 2860 BEQ . no leading zero 
0901—- 09 BO 2870 ORA #$B0 make character 
0903- ED FD 28 JSR COUT print it 

0900- 2890 .3 PLA recover units 
0907=- 09 BO at ORA #$B0 make character 
0909—- 4C ED FD 2910 JMP COUT return through COUT 


32-bit Values in Version 2.0 -- A Mixed Blessing......Bob S-C 


In previous versions of the S-C assemblers, expressions were 
evaluated in 16 bits, and symbol values were kept in the table 
in 16-bit form. Version 2.0 works with 32-bit expressions and 
symbol values. We added this feature for your benefit. but it 
May sometimes be a mixed blessing. 


For example, Bob Bernard had a problem with a program which 
assembled perfectly under Version 1 0. but gave countless BAD 
ADDRESS errors in version 2.0. We traced the problem to his 
Origin statement. which was ".OR -31488*%. In older versions, 
-31488 is the same as $8500, but in version 2.0 it is 
SFFFF8500. The following code will not assemble: 


-OR -31488 
SSS JMP SSS 


Why? Because the value of SSS is also SFFFF8500, and it will 
not fit in a JMP instruction. In 65816 mode, uSing a JML 
instruction, it would be legal. 


Two ways to fix come to mind. You normally work in hexadecimal 
when you are in assembly language, rather than decimal. 
Therefore, change the origin statement to “.OR $8500". Or. if 
you really want to use decimal, write “.OR 65536-31488". 


Another owner of version 2.0 had a problem with a program that 
used many macros, and lots of private labels. Private labels 
are the ones used inside macro definitions, which are written 
with a colon and a one or two digit number. The private label 
table normally begins at S$FFF and grows downward toward $800. 
His program assembled with no problems before. but under 
version 2.0 it got a MEM FULL error Reason, again, the 32-bit 
symbol values. Each entry in the private label table now takes 
two more bytes, so he ran out of space sooner- His solution 
was to move the beginning of the label table higher. 


Apple Assembly Line is published monthly by S-C SOFTWARE CORPORATION, P.O. Box 
280300, Dallas, Texas 75228. Phone (214) 324-2050. Subscription rate is $18 
per year in the USA, sent Bulk Mail; add $3 for First Class postage in USA, 
Canada. and Mexico; add $14 postage for other countries. Back issues are 
available for $1.80 each (other countries add $1 per back issue for postage). 


All material herein is copyrighted by S-C SOFTWARE CORPORATION, all rights 
reserved. (Apple is a registered trademark of Apple Computer, Inc.) 
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